Features Introduced in the 9.2.0 Windows Release

This section provides details about the new features introduced in the Windows 9.2.0 release.

Unified API Enhancements

The following major enhancements, related to the Unified API, are included in this release. For more information, refer to the Sentinel RMS API Reference Guide.

Added New License Parsing Library

In this release, the Licgen_parse library is added to the Unified API set. This library contains functions related to license parsing. The following new API are also introduced as a part of this library:

Sentinel RMS 9.2.0 Release Notes

>Windows

>Linux

>Mac

>AIX

>HPUX

>Solarisx86

>Solaris Sparc

API	Purpose
sntl_licgen_parse	Allows the user to parse and view the license details.
sntl_licgen_free	Releases the memory resources allocated by the sntl_licgen_parse API.

Added New API

In this release, the following API are added:

API	Header File	Purpose
sntl_licensing_register_callback	licensing.h	Allows the user to register software vendor-defined callback. In this release, the callbacks can be provided for supporting custom (CustomEx) locking
sntl_licensing_uninstall	licensing.h	Allows the user to uninstall a license from the designated License Manager’s memory and license file.
sntl_licgen_parse	Licgen_parse.h	Allows the user to parse and view the license details.
sntl_licgen_free	Licgen_parse.h	Releases the memory resources allocated by the sntl_licgen_parse API.

Renamed Existing API

In this release, the following API are renamed to reflect their actual use:

New API (v9.2.0)	Existing API (v9.1.0)
sntl_licensing_transfer()	sntl_licensing_transfer_license
sntl_licensing_install	sntl_licensing_install_license

New API (v9.2.0)

Existing API (v9.1.0)

sntl_licensing_transfer()

sntl_licensing_transfer_license

sntl_licensing_install

sntl_licensing_install_license

Added New Attributes

In this release, the following attributes are added to existing API:

Attribute Key	API	Description
SNTL_ATTR_APPCONTEXT_MINIMUM_SIGNING_KEY_INDEX	sntl_ licensing_attr_new	This attribute is a part of the Enhancements Related to License Security. Refer to the Added a New Attribute in Unified API section for more information.
SNTL_ATTR_REFRESH_UNITS_REQUIRED	sntl_licensing_refresh_attr()	Sets the number of tokens required at the time of renewing a license authorization. Related Traditional API enhancement is defined in the Support for Specifying the Number of Tokens During License Renewal section.
SNTL_ATTR_LOGIN_DISABLE_GRACE_BROADCAST	sntl_licensing_login_attr	Suppresses the network broadcasts (looking for a License Manager with licenses) in the case of grace licenses.

Attribute Key

API

Description

SNTL_ATTR_APPCONTEXT_MINIMUM_SIGNING_KEY_INDEX

sntl_ licensing_attr_new

This attribute is a part of the Enhancements Related to License Security.
Refer to the Added a New Attribute in Unified API section for more information.

SNTL_ATTR_REFRESH_UNITS_REQUIRED

sntl_licensing_refresh_attr()

Sets the number of tokens required at the time of renewing a license authorization.

Related Traditional API enhancement is defined in the Support for Specifying the Number of Tokens During License Renewal section.

SNTL_ATTR_LOGIN_DISABLE_GRACE_BROADCAST

sntl_licensing_login_attr

Suppresses the network broadcasts (looking for a License Manager with licenses) in the case of grace licenses.

XSDs Available in the Installtion Directory

Starting version v10.2, XSDs used by Unified API are included in the installation at the following location:
<installdir>\9.2\Development\XSDs

sntl_licensing_get_info API Enhancements

This section briefly describes the various enhancements done in the sntl_licensing_get_info API. For more information, refer to the Sentinel RMS API Reference Guide.

Added New Query types

In this release, the sntl_licensing_get_info API is enhanced to provide the following additional information:

>Locking Code Information (lockCodeInfo) - Generates the locking code-based on the specified fingerprint.

>Lease mode license Synchronization Information - Provides information about the current status of the lease.

Renaming of Query Type Macros

In this release, the existing query type macros of the sntl_licensing_get_info API are also renamed to accept the required version. The old query types will be deprecated in the future versions.

For more information, refer to the licensing.h header file and Sentinel RMS API Reference Guide.

Support for Obtaining Raw Fingerprint Values

In this release, the fingerprintInfo query type is updated to provide additional information aboout raw fingerprint values. Earlier, it used to provides hashed values of fingerprints. To support this enhancement, the fingerprint information XML template has been updated. The version of the XML template has been updated to v1.1.

Both v1.0 and v1.1 XML templates are supported in this release.

Enhancement Related to License Revocation

In this release, the sntl_licensing_install API is updated to support License Revocation workflow. This API now supports the installation of the License Revocation Request (LRR) and return the License Revocation Acknowledgment (LRA), for standalone and network licenses.

Earlier, this API was used for license installation only.

For more information about the license revocation and corresponding process, see the License Revocation Workflow section of the sntl_licensing_install API.

Enhancements Related to License Security

In this release, the following enhancements are made to improve license security:

Support for RSA 2048-Signed Licenses

Prior to this release, 128-bit AES algorithm was used for license encryption. Starting v9.2.0, licenses are also signed using the industry standard RSA 2048 algorithm-based public key cryptosystem.

This enhancement, in combination with the current AES-based license encryption, significantly improves the license security.

License Version Upgraded to version 18

Due to updates in the license security, the license version has been upgraded to version 18.

Added a New API in Traditional API

A new API VLSsetMinimumSigningKeyIndex is added to the traditional API set. This API can be used for defining the license version and security-related preferences of the software vendor. Available options are:

>VLS_DEFAULT_SIGNING_KEY_INDEX - Default option. The License Manager can grant a v18/v17 (or below) license, in response to the subsequent license request.

>VLS_HIGHER_SECURITY_SIGNING_KEY_INDEX - Specifies the license version and security preference of the software vendor. In this case, the License Manager must grant a RSA 2048 signed version 18 license in response to the subsequent license request. If the required version (v18) is not available, the license request will return an error.

Added a New Attribute in Unified API

In this release, a new attribute SNTL_ATTR_APPCONTEXT_MINIMUM_SIGNING_KEY_INDEX is defined in the sntl_licensing_attr_set API. This attribute defines the license version-related preferences of a software vendor.

If required, the software vendor can enforce the License Manager to grant v18 RSA 2048 signed licenses, to enhance license security. Available options are:

>SNTL_RSA_SIGNING_KEY_INDEX - Default option. Specifies the license version and security preference of the software vendor. In this case, the License Manager must grant a RSA 2048 signed v18 license in response to the subsequent license request. If the required version (v18) is not available, the license request will return an error.

>SNTL_AES_SIGNING_KEY_INDEX - The License Manager can grant a v18/v17 (or below) license, in response to the subsequent license request.

For more information, refer to the Secured Licensing section of the Sentinel RMS Developer Guide.

Traditional API Enhancements

The following major enhancements, related to the Traditional API, are included in this release. For more information, refer to the "Traditional API" section of the Sentinel RMS API Reference Guide.

Added New API for Clean-up of Existing Sessions/License Keys

In this release, a new API VLScleanupIssuedKeys is introduced. This API allows vendors to clean-up previous or existing sessions/license keys on the RMS License Manager.

Support for Specifying the Number of Tokens During License Renewal

Starting v9.2.0, you can use the new_units_reqd parameter of LSUpdate API for specifying the required number of tokens during license renewal.

For Unified API, a new attribute SNTL_ATTR_REFRESH_UNITS_REQUIRED is defined in the Added New Attributes section.

Enhancements Related to Sample Programs

This section briefly describes various enhancements related to sample programs. For more information, refer to the Samples Readme included in the Sentinel RMS installation at the following location:

<installdir>/9.2/samples

Added New Sample Programs

In this release, the following samples are added:

Sample	Description
sntl_lease_demo	Demonstrates license enforcement in standalone lease modes.
sntl_lease_tool	Demonstrates fingerprint registration and force transfer for standalone lease modes.
sntl_revoke	Demonstrates license revocation and related tasks.

Enhanced Existing Sample Programs

In this release, the following samples are enhanced to include additional functionality introduced in this release:

Sample	Description
sntl_tool	This sample program is enhanced to demonstrate locking, license parsing and uninstall functionality.
gen_permission	Demonstrates the generation of License Revocation Request at the Developer end.
verify_revoke	Demonstrates the verification of License Revocation Acknowledgement using Unified API.
sample	This sample program is renamed to capacity.

Removed Sample Programs from Sentinel RMS SDK Installation

In this release, the following sample programs have been removed from the Sentinel RMS SDK installation:

>bounce

>dotsnnet

>lslic

>Example

>revokesample

>qbounce (deprecated)

Support for Windows Server 2016

Support for the Windows Server 2016 (64-bit) operating systems is added in this release.

Support for MSVS 2015 Compiler

Support for the Microsoft Visual Studio 2015 is added in this release for the following libraries:

>Licensing libraries (standalone, network, and integrated)

>System initialization library

>Persistence cleaning library

>License decode library

Enhancements in Java Interface for Unified API

In this release, the Java interface for Unified API is also updated to reflect the enhancements listed in the section Unified API Enhancements.

Enhancements in DotNet Interface for Unified API

In this release, the DotNet interface for Unified API is also updated to reflect the enhancements listed in the section Unified API Enhancements.

Miscellaneous Changes

In this release, the following changes are also included:

Support for Two License Managers in a Redundant License Manager Pool

From this release onward, it is possible to create a redundant pool consisting of only two License Managers. Earlier, at least three License Managers were required to create a redundant pool. In the case of two License Managers, the majority rule should be turned off in WlscGen and lscgen (which was enabled by default until this release).

Enhancement Related to lsgenInit Utility

In this release, the –np (No pause) is added to the lsgeninit utility.

If this option is used, the utility displays the command prompt after successful execution. Otherwise, the user needs to press the Enter key to display the command prompt.

Support for Auto Timer for Console Applications

In this release, support for auto timer is added for Windows (32-bit and 64-bit) console applications.